<h1>Repository XML</h1>
<div class="abstract">
  The Knopflerfish OSGi Repository XML bundle provides Repository
  services based on the contents of XML documents using the OSGi
  specified schema
  <code>http://www.osgi.org/xmlns/repository/v1.0.0</code>.
</div>

<h2>Description</h2>

  <p>The Knopflerfish OSGi Repository XML bundle creates Repository
  services that reflects the contents of XML documents following the
  OSGi specified schema:
  <code>http://www.osgi.org/xmlns/repository/v1.0.0</code>.</p>


<div style="clear:both"></div>
<h2>Configuration</h2>

  <p>The XML documents to parse and present as Repository services can
  be configured in several ways:</p>

  <ul>
    <li>Using framework (system) properties.
    <li>Using CM configuration.
    <li>Using the
        <code>org.knopflerfish.service.repository.XmlBackedRepositoryFactory</code>
	registered by the bundle.
  </ul>


<h3>Configuration properties</h3>

  <p>The Repository XML bundle supports the following framework
  properties for configuration:</p>

<table class="man">
  <tr>
    <th>Name</th>
    <th>Description</th>
    <th>Value type</th>
    <th>Default value</th>
  </tr>

  <tr>
    <td>org.knopflerfish.repository.xml.urls</td>
    <td>

        Comma separated list of OSGi Repository XML URLs for instantiating 
        Repository Services from.

    </td>
    <td>String</td>
    <td>&mdash;</td>
  </tr>
</table>


<h3>Configuration via Configuration Management</h3>

  <p>The Repository XML bundle uses a factory PID to configure
  repository services. Each factory PID configuration instance
  corresponds to one XML file for which one Repository service will be
  created.</p>

  <p>The factory PID is
  <code>org.knopflerfish.repository.xml.MSF</code>.</p>

<table class="man">
  <tr>
    <th>Name</th>
    <th>Description</th>
    <th>Value type</th>
    <th>Default value</th>
  </tr>

  <tr>
    <td>url</td>
    <td>

        URL pointing to the location of an OSGi Repository XML file to instantiate
	a Repository Service from.

    </td>
    <td>String</td>
    <td>&mdash;</td>
  </tr>
</table>
